package com.example.domain.repository;

import com.example.domain.entity.Unit;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 计量单位Repository
 * 
 * @author Means
 * @since 2025-10-27
 */
@Repository
public interface UnitRepository extends JpaRepository<Unit, String> {
    
    /**
     * 根据单位名称查询
     * 
     * @param name 单位名称
     * @return 单位对象
     */
    Optional<Unit> findByName(String name);
    
    /**
     * 根据单位代码查询（主键查询的业务语义方法）
     * 
     * @param code 单位代码
     * @return 单位对象
     */
    Optional<Unit> findByCode(String code);
    
    /**
     * 模糊查询单位名称
     * 
     * @param keyword 关键字
     * @return 单位列表
     */
    List<Unit> findByNameContaining(String keyword);
    
    /**
     * 查询所有单位并按名称排序
     * 
     * @return 单位列表
     */
    List<Unit> findAllByOrderByNameAsc();
    
    /**
     * 根据单位代码批量查询
     * 
     * @param codes 单位代码列表
     * @return 单位列表
     */
    @Query("SELECT u FROM Unit u WHERE u.code IN :codes")
    List<Unit> findByCodes(@Param("codes") List<String> codes);
}

